Open the device (connect the device).
int MV_CC_OpenDevice( void *handle, unsigned int nAccessMode = MV_ACCESS_Exclusive, unsigned short nSwitchoverKey = 0 );
[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.
[IN] Device access mode, it is exclusive mode by default, see the table below for details.
|
Macro Definition |
Value |
Description |
|---|---|---|
|
MV_ACCESS_Exclusive |
1 |
Exclusive permission, for other apps, the CCP register is only allowed to be read |
|
MV_ACCESS_ExclusiveWithSwitch |
2 |
Preempt permission in mode 5, and then open with exclusive permission |
|
MV_ACCESS_Control |
3 |
Control permission, for other apps, all registers are allowed to be read |
|
MV_ACCESS_ControlWithSwitch |
4 |
Preempt permission in mode 5, and then open with control permission |
|
MV_ACCESS_ControlSwitchEnable |
5 |
Open with control permission that can be preempted |
|
MV_ACCESS_ControlSwitchEnableWithKey |
6 |
Preempt permission in mode 5, and then open with control permission that can be preempted |
|
MV_ACCESS_Monitor |
7 |
Open device with reading mode, suitable under control permission |
[IN] Key for switching permissions, it is null by default, and it is valid when access mode supports permission switching (2/4/6 mode).
Return MV_OK(0) on success, and return Error Code on failure.
You can find the specific device and connect according to inputted device parameters.
When calling this API, the parameters nAccessMode and nSwitchoverKey are optional, and the device access mode is exclusive by default. Currently the device does not support the following preemption modes: MV_ACCESS_ExclusiveWithSwitch, MV_ACCESS_ControlWithSwitch, and MV_ACCESS_ControlSwitchEnableWithKey.
For USB3Vision device, the parameters nAccessMode and nSwitchoverKey are invalid.
The following sample code is for reference only.
#include "MvCameraControl.h"
void main()
{
int nRet = -1;
void* m_handle = NULL;
//Enumerate all devices corresponding to specified transport protocol within subnet
unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
int nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
if (MV_OK != nRet)
{
printf("error: EnumDevices fail [%x]\n", nRet);
return;
}
int i = 0;
if (m_stDevList.nDeviceNum == 0)
{
printf("no camera found!\n");
return;
}
//Select the first found online device and create device handle
int nDeviceIndex = 0;
MV_CC_DEVICE_INFO m_stDevInfo = {0};
memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));
nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);
if (MV_OK != nRet)
{
printf("error: CreateHandle fail [%x]\n", nRet);
return;
}
unsigned int nAccessMode = MV_ACCESS_Exclusive;
unsigned short nSwitchoverKey = 0;
//Connect device
nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
if (MV_OK != nRet)
{
printf("error: OpenDevice fail [%x]\n", nRet);
return;
}
//...other processing
//Shut device and release resource
nRet = MV_CC_CloseDevice(m_handle);
if (MV_OK != nRet)
{
printf("error: CloseDevice fail [%x]\n", nRet);
return;
}
//Destroy handle and release resource
nRet = MV_CC_DestroyHandle(m_handle);
if (MV_OK != nRet)
{
printf("error: DestroyHandle fail [%x]\n", nRet);
return;
}
}
Open the device (connect the device).
int MV_CC_OpenDevice( void *handle, unsigned int nAccessMode = MV_ACCESS_Exclusive, unsigned short nSwitchoverKey = 0 );
[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.
[IN] Device access mode, it is exclusive mode by default, see the table below for details.
|
Macro Definition |
Value |
Description |
|---|---|---|
|
MV_ACCESS_Exclusive |
1 |
Exclusive permission, for other apps, the CCP register is only allowed to be read |
|
MV_ACCESS_ExclusiveWithSwitch |
2 |
Preempt permission in mode 5, and then open with exclusive permission |
|
MV_ACCESS_Control |
3 |
Control permission, for other apps, all registers are allowed to be read |
|
MV_ACCESS_ControlWithSwitch |
4 |
Preempt permission in mode 5, and then open with control permission |
|
MV_ACCESS_ControlSwitchEnable |
5 |
Open with control permission that can be preempted |
|
MV_ACCESS_ControlSwitchEnableWithKey |
6 |
Preempt permission in mode 5, and then open with control permission that can be preempted |
|
MV_ACCESS_Monitor |
7 |
Open device with reading mode, suitable under control permission |
[IN] Key for switching permissions, it is null by default, and it is valid when access mode supports permission switching (2/4/6 mode).
Return MV_OK(0) on success, and return Error Code on failure.
You can find the specific device and connect according to inputted device parameters.
When calling this API, the parameters nAccessMode and nSwitchoverKey are optional, and the device access mode is exclusive by default. Currently the device does not support the following preemption modes: MV_ACCESS_ExclusiveWithSwitch, MV_ACCESS_ControlWithSwitch, and MV_ACCESS_ControlSwitchEnableWithKey.
For USB3Vision device, the parameters nAccessMode and nSwitchoverKey are invalid.
The following sample code is for reference only.
#include "MvCameraControl.h"
void main()
{
int nRet = -1;
void* m_handle = NULL;
//Enumerate all devices corresponding to specified transport protocol within subnet
unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
int nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
if (MV_OK != nRet)
{
printf("error: EnumDevices fail [%x]\n", nRet);
return;
}
int i = 0;
if (m_stDevList.nDeviceNum == 0)
{
printf("no camera found!\n");
return;
}
//Select the first found online device and create device handle
int nDeviceIndex = 0;
MV_CC_DEVICE_INFO m_stDevInfo = {0};
memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));
nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);
if (MV_OK != nRet)
{
printf("error: CreateHandle fail [%x]\n", nRet);
return;
}
unsigned int nAccessMode = MV_ACCESS_Exclusive;
unsigned short nSwitchoverKey = 0;
//Connect device
nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
if (MV_OK != nRet)
{
printf("error: OpenDevice fail [%x]\n", nRet);
return;
}
//...other processing
//Shut device and release resource
nRet = MV_CC_CloseDevice(m_handle);
if (MV_OK != nRet)
{
printf("error: CloseDevice fail [%x]\n", nRet);
return;
}
//Destroy handle and release resource
nRet = MV_CC_DestroyHandle(m_handle);
if (MV_OK != nRet)
{
printf("error: DestroyHandle fail [%x]\n", nRet);
return;
}
}